<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    <meta content="text/html; charset=ISO-8859-1"
          http-equiv="content-type">
    <title>Installing the Java Telnet Portlet</title>
    <meta content="Harsha Ramesh" name="author">
    <style>
      A:link { COLOR: #666666; }
      A:active { COLOR: #666666; }
      A:visited { COLOR: #666666; }
      A.navigation:link { COLOR: #666666; }
      A.navigation:active { COLOR: #666666; }
      A.navigation:visited { COLOR: #666666; }
      H2 { BORDER-BOTTOM: #c0c0c0 2px solid; COLOR: #666666 }
      H3 { COLOR: #666666 }
    </style>
  </head>
  <body>
    <h1 style="color: rgb(51, 51, 51);">Java Telnet Portlet</h1>
    <h2>Installing the Java Telnet Portlet</h2>
    <table style="width: 100%; text-align: left;" border="1">
      <tbody>
        <tr>
          <td style="vertical-align: top; width: 20%;">Creation Date<br>
          </td>
          <td style="vertical-align: top;">August 12<sup>th</sup>, 2004<br>
          </td>
        </tr>
        <tr>
          <td style="vertical-align: top; width: 20%;">Last updated<br>
          </td>
          <td style="vertical-align: top;">November 27<sup>th</sup>, 2006<br>
          </td>
        </tr>
        <tr>
          <td style="vertical-align: top; width: 20%;">Version<br>
          </td>
          <td style="vertical-align: top;">2.1<br>
          </td>
        </tr>
      </tbody>
    </table>
    <br>
    <h3><span style="font-weight: bold;">Contents</span></h3>
    <div style="margin-left: 40px;"><a href="#introduction"><span
        style="font-weight: bold;">Introduction</span></a><br
        style="font-weight: bold;">
      <a href="#deploy_the_provider"><span style="font-weight: bold;">Deploying
      the Provider</span></a><br style="font-weight: bold;">
      <div style="margin-left: 40px;"><a href="#file_structure"><span
          style="font-weight: bold;">File Structure</span></a><br
          style="font-weight: bold;">
      </div>
      <a href="#publish"><span style="font-weight: bold;">Publishing the Java
      Telnet Portlet</span></a><br>
      <div style="margin-left: 40px;"><a href="#customize_portlet"><span
          style="font-weight: bold;">Customizing the Portlet</span></a><br>
      </div>
      <a href="#compatibility_matrix"><span style="font-weight: bold;">Compatibility
      Matrix</span></a><br>
      <a href="#proposed_future_enhancements"><span style="font-weight: bold;">Proposed
      Future Enhancements</span></a><br style="font-weight: bold;">
      <a href="#license"><span style="font-weight: bold;">License</span></a><br>
      <a href="#Issues"><span style="font-weight: bold;">Issues</span></a><br>
    </div>
    <br>
    <h2><a name="introduction"></a>Introduction</h2>
    In today's world, enterprises are gaining competitive advantage and
    realizing increased productivity by deploying an enterprise portal
    within their IT infrastructure. The most important feature of a portal
    is content aggregation - integrating content from different sources
    into a web page. Given all the advanced features provided by enterprise
    portals, they still provide only a web-based access to the systems.
    There are many times when a simple native telnet access to a system
    provides a much more comprehensive interaction than can be achieved via
    the web. The Java Telnet Portlet makes an attempt at bridging this gap
    by integrating the telnet application with OracleAS Portal. The Java
    Telnet Portlet encapsulates the <a href="http://javassh.org/">JTA
    Applet</a>, and publishes it as a portlet.<br>
    <br>
    <h2><a name="deploy_the_provider"></a>Deploying the provider</h2>
    Before you start
    with the installation, it is important for you to make sure the
    PDK-Java installation and configuration is done. You can verify if
    PDK-Java is configured by running the test page URL, for example
    <span style="color: rgb(51, 51, 153); font-family: monospace;">http://{server}:{port}/jpdk/providers/sample</span>.
    If
    this URL shows up the list of all sample portlets, your PDK setup is
    fine. If not,please find a link to <a
      href="http://www.oracle.com/technology/products/ias/portal/html/installing.pdkjava.v2.html">Installing
    the PDK-Java Framework and Sample Providers</a> document that explains
    configuring PDK on
    different combinations of OC4J instances.
    <br>
    <h3><a name="file_structure"></a>File Structure</h3>
    The Java Telnet Portlet comes as a zip file with the following file
    structure<br>
    <br>
    <table style="width: 100%; text-align: left;">
      <tbody>
        <tr>
          <td style="vertical-align: top; font-family: monospace;">JavaTelnetPortlet_JPDK.zip</td>
          <td style="vertical-align: top; font-family: monospace;"><br>
          </td>
        </tr>
        <tr>
          <td style="vertical-align: top; font-family: monospace;">
            <div style="margin-left: 40px;">|-&gt; installation.html</div>
          </td>
          <td style="vertical-align: top; font-family: monospace;">(this
            document)<br>
          </td>
        </tr>
        <tr>
          <td style="vertical-align: top; font-family: monospace;">
            <div style="margin-left: 40px;">|-&gt; images<br>
            </div>
          </td>
          <td style="vertical-align: top; font-family: monospace;">(contains
            the images that are part of this document)<br>
          </td>
        </tr>
        <tr>
          <td style="vertical-align: top; font-family: monospace;">
            <div style="margin-left: 40px;">|-&gt; JavaTelnetPortlet_JPDK.ear</div>
          </td>
          <td style="vertical-align: top; font-family: monospace;">The
            enterprise archive containing the telnet portlet<br>
          </td>
        </tr>
      </tbody>
    </table>
    <br>
    Extract the contents of the zip file and then deploy the ear
    file to your OracleAS / OC4J instance. For more information on
    deployment instructions, please refer to the well written document on <a
      href="http://www.oracle.com/technology/products/ias/portal/html/installing.integration.v2.html">Installing
    Integration Portlets</a>.<br>
    <br>
    <h2><a name="publish"></a>Publishing the Java Telnet Portlet</h2>
    If you have successfully deployed the Java Telnet Portlet, then you
    should be able to access your provider test page at the following URL<br>
    <div style="margin-left: 40px;"><span style="font-family: monospace;">http://&lt;host&gt;:&lt;port&gt;/JavaTelnetPortlet_JPDK/providers<br>
        <br>
      </span>ex: <span style="font-family: monospace;">http://my.company.com:8888/JavaTelnetPortlet_JPDK/providers<br>
        <br>
    </span></div>
    &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; &nbsp;&nbsp;&nbsp; , in case you
    see any errors in the page, then please re-run through
    your deployment once again.<br>
    <br>
    Now, register this URL with your OracleAS Portal, and while registering
    the Portal, make sure that under the '<span style="font-style: italic;">User/Session
    Information</span>' section
    you select '<span style="font-style: italic;">User' </span>and set the
    '<span style="font-style: italic;">Login Frequency</span>' to '<span
      style="font-style: italic;">Once Per User
    Session</span>'.<br>
    <h3><a name="customize_portlet"></a>Customizing the Portlet</h3>
    <ol>
      <li>Once you have registered the portlet, go ahead and drop the
        portlet
        onto your portal page, and when viewed the page will request you to
      customize the portlet by supplying the server to connect to (Figure 1).</li>
    </ol>
    <br>
    <img alt="" src="images/show_mode.jpg"
         style="width: 1024px; height: 150px;"><br>
    <div style="text-align: center;"><small>Figure 1<br>
    </small></div>
    <br>
    <br>
    <ol start="2">
      <li>Click on customize and set the portlet title and the host server
        to
      telnet to (Figure 2).</li>
    </ol>
    <img alt="" src="images/edit_mode.jpg"
         style="width: 950px; height: 300px;"><br>
    <div style="text-align: center;"><small>Figure 2</small><br>
    </div>
    <br>
    <br>
    <ol start="3">
      <li>Once you have specified the host address; in the view mode, you
        will be
        prompted with a certificate requesting for you to grant permission to
        execute the applet (Figure 3). If you wouldn't want to be prompted with
        this
        certificate everytime you visit this page, then select the option of
      'Always'.</li>
    </ol>
    <br>
    <br>
    <img alt="" src="images/cert.jpg" style="width: 1000px; height: 500px;"><br>
    <br>
    <div style="text-align: center;"><small>Figure 3</small><br>
    </div>
    <br>
    <br>
    <ol start="4">
      <li>Once you have accepted the certificate you should be able to see
        the
        applet connected to the server (Figure 4), click on the applet to set
        the focus
      and you are all set set to work on the terminal.</li>
    </ol>
    <br>
    <br>
    <img alt="" src="images/show_mode_1.jpg"
         style="width: 1024px; height: 600px;"><br>
    <div style="text-align: center;"><small>Figure 4</small><br>
    </div>
    <br>
    <br>
    <h2><a name="compatibility_matrix"></a>Compatability Matrix</h2>
    I have tested the portlet in the following environments: Portal 9.0.2.6
    +, JDK 1.4.2_03+, Mozilla 1.6+ and IE 6.0+. Incase you face any issues
    such as 'load: class de.mud.jta.Applet not
    found', please make sure that you are running the latest Java Runtime
    Environment.<br>
    Another point to note is, that the JRE version and the browser versions
    are those available on the client's machine. So it is not necessary
    that the JDK on the Portal machine be upgraded.<br>
    <br>
    <h2><a name="proposed_future_enhancements"></a>Proposed Future
    Enhancements</h2>
    <ul>
      <li>
        I plan to enhance the portlet to enable connecting to SSH servers also.
        This feature is provided by the JTA application, but I am still testing
        it out a little bit.
      </li>
    </ul>
    <br>
    <h2><a name="license"></a>License</h2>
    The JTA is provided under the <a href="http://javassh.org/space/License+Agreement">GNU GPL v2.0.</a>
    Hence, this portlet is also provided under the same license.
    <br>
    <br>
    <h2><a name="Issues"></a>Issues</h2>
    This project is hosted on <a href="http://code.google.com/p/java-telnet-portlet/">Google Code</a>.
    In the event that you face any issues using this portlet, please file the issue on the project's
    <a href="http://code.google.com/p/java-telnet-portlet/issues/list">Issuezilla</a>.
    <br>
    <br>
    <table style="width: 100%; text-align: left;" border="1">
      <tbody>
        <tr>
          <td style="vertical-align: top;" colspan="2"><span style="font-weight: bold;">Revision
            History</span><br>
          </td>
        </tr>
        <tr>
          <td/>
          <td style="vertical-align: top;">
            <table style="width: 100%; text-align: left;">
              <tbody>
                <tr>
                  <td style="vertical-align: top; width: 25%;">Revision Number<br>
                  </td>
                  <td style="vertical-align: top;">1.0</td>
                </tr>
                <tr>
                  <td style="vertical-align: top; width: 25%;">Date of
                    Revision<br>
                  </td>
                  <td style="vertical-align: top;">August 12<sup>th</sup>,
                    2004<br>
                  </td>
                </tr>
                <tr>
                  <td style="vertical-align: top; width: 25%;">Changes Made</td>
                  <td style="vertical-align: top;">Created the Document.
                  </td>
                </tr>
              </tbody>
            </table>
          </td>
        </tr>
        <tr>
          <td/>
          <td style="vertical-align: top;">
            <table style="width: 100%; text-align: left;">
              <tbody>
                <tr>
                  <td style="vertical-align: top; width: 25%;">Revision Number<br>
                  </td>
                  <td style="vertical-align: top;">2.0</td>
                </tr>
                <tr>
                  <td style="vertical-align: top; width: 25%;">Date of
                    Revision<br>
                  </td>
                  <td style="vertical-align: top;">November 17<sup>th</sup>,
                    2006<br>
                  </td>
                </tr>
                <tr>
                  <td style="vertical-align: top; width: 25%;">Changes Made</td>
                  <td style="vertical-align: top;">
                    Updated the JTA.jar to version 2.6
                  </td>
                </tr>
              </tbody>
            </table>
        </td>
      </tr>
      <tr>
        <td/>
        <td>
            <table style="width: 100%; text-align: left;">
              <tbody>
                <tr>
                  <td style="vertical-align: top; width: 25%;">Revision Number<br>
                  </td>
                  <td style="vertical-align: top;">2.1</td>
                </tr>
                <tr>
                  <td style="vertical-align: top; width: 25%;">Date of
                    Revision<br>
                  </td>
                  <td style="vertical-align: top;">November 27<sup>th</sup>,
                    2006<br>
                  </td>
                </tr>
                <tr>
                  <td style="vertical-align: top; width: 25%;">Changes Made</td>
                  <td style="vertical-align: top;">
                    Added edit defaults settings to the portlet.
                  </td>
                </tr>
              </tbody>
            </table>
          </td>
        </tr>
      </tbody>
    </table>
  </body>
</html>
